
🐱 【BongoCat Mod for Windows】
	欢迎使用 BongoCat Mod！
	本 Mod 为您提供丰富的游戏便利功能。
	请仔细阅读以下说明，确保顺利安装和使用。
	如有问题，请在相关社区留言。祝您游戏愉快！


🔗【相关链接】
	Mod 下载地址（长期有效）：		https://xv40.lanzouu.com/b0fpy9v9e	（密码：4qek）
	小黑盒（更新 BongoCat 动态）：	https://www.xiaoheihe.cn/app/bbs/link/170065045
	哔哩哔哩：						https://www.bilibili.com/opus/1133838398032707585
	小红书：							http://xhslink.com/o/2vso5DJyloF
	
	
✨【功能一览】
	🔑 宝箱数量显示 					– 获悉您拥有的宝箱总数量
	🎁 自动开启宝箱 					– 全自动开箱，无需手动干预
	⏳ 开箱时间可调 					– 自定义开箱间隔
	💫 开箱免扣除 -1000 点击数 		– 开箱不消耗点击数
	🚀 一键获得 100万 点击数 		– 解锁 “点数成就”
	🏆 一键解锁 “非点数成就”			- 解锁 “非点数成就”
	😼 猫猫位置排序 					– 多种排列方式，多人联机体验极佳
	🏆 多项游戏优化改进 				– 细节体验提升
	
	
📥【安装步骤 - Windows】
	⚠️ 1.确保游戏已完全关闭
	
	💡 2.验证游戏文件的完整性：
			· Steam -> 右键 BongoCat -> 属性 -> 已安装文件 -> 验证游戏文件的完整性
			· 等待验证完成，并确保 Steam 下载进度完成
			
	📁 3.安装 Mod 文件：
			· 将下载的 Assembly-CSharp.dll 文件复制或剪切
			· 粘贴到以下路径：BongoCat 游戏目录\common\BongoCat\BongoCat_Data\Managed 文件夹内
			· 当系统提示 “替换或跳过文件” 时，选择 “替换目标中的文件”
			
	🎮 4.启动游戏验证：
			· 运行游戏，查看宝箱图标下方是否出现 “蓝色数字”。若出现，则 Mod 安装成功
	
	
🗑️ 【卸载方法】
	✅ 方法 1：Steam → 右键 BongoCat → 属性 → 已安装文件 → 验证游戏文件的完整性
	✅ 方法 2：进入 BongoCat 游戏设置界面 -> 拖动至最下方，点击 “更新并重启”
	

🔔【使用说明】
	1.打开 BongoCat 设置界面
	2.根据个人需求，启用或关闭各项 Mod 功能
	3.所有修改实时生效，无需重启游戏
	
💡【常见问题】

	《游戏机制相关》：
			Q：游戏主要玩法？
			A：通过敲击键鼠获得点击数，
				每在线 30 分钟，可获得 1 个物品宝箱 + 1 个表情宝箱，
				开启宝箱随机获得物品/表情，每次开启消耗 1 个宝箱 + 1000 点击数。


			Q：宝箱下面的蓝色数字是什么？倒计时下面的蓝色数字呢？
			A：都是当前拥有的宝箱数量（物品宝箱与表情宝箱分开显示）。


			Q：为什么我有很多宝箱？
			A：如果在前一个 30 分钟结束时未开启宝箱，系统会将宝箱暂存至您的 Steam 库存，因此可累积多个。


			Q：如何查询宝箱的详细交易记录？
			A：Steam → 库存 → 点击右上角 “更多...” → 查看库存交易记录 → 点击 “过滤器选项” → 勾选 Bongo Cat。

				Chest Token：物品宝箱
				Emote Chest Token：表情宝箱
				
				交易记录中可看到宝箱的获得与消耗明细。


			Q：能否加速宝箱获取时间（30分钟）？
			A：不能，此为游戏硬性机制。
		
		
	《Mod 使用相关》
			Q：宝箱数量不显示，或只显示一个？
			A：请检查 Mod 设置中是否开启了 “点击计数栏，隐藏宝箱图标”。若开启，点击猫猫下方的点击数栏即可切换显示状态。


			Q：自动开箱已开启，但没有自动执行？
			A：需要手动开启一次宝箱作为确认，之后便会自动运行。


			Q：开箱时间设置成 30 秒会有什么问题？
			A：可能导致物品合成异常、宝箱数量更新延迟等问题。建议设置 1 分钟或以上，并避免短时间内频繁开箱/合成，以免 Steam 临时限制交互速率。


			Q：游戏物品、皮肤全没了？倒计时不走或显示 Init？
			A：此现象表明游戏无法从 Steam 库存加载数据。请耐心等待，或开启游戏加速器后重试。
			
			
	《异常与反馈》
			Q：能不能给 Mod 加入 xxx 功能？
			A：Mod 目前已趋于完善，短期内不再计划新增功能。如有创意或想法，建议直接向游戏作者反馈（Discord）。
			

😼【猫猫位置排序】

					 1.游戏默认排序 -> 猫猫数量能容纳一行时，优先基于 “主猫” 位置横向平铺；否则随机排列。

		2.从左下角起，向右上均匀平铺 -> 从屏幕左下角开始，逐行向右上均匀排列。	（若屏幕不足以平铺所有猫猫，将自动退回随机位置排序）
		 
		3.从右下角起，向左上均匀平铺 -> 从屏幕右下角开始，逐行向左上均匀排列。	（若屏幕不足以平铺所有猫猫，将自动退回随机位置排序）
		 
		4.从左上角起，向右下均匀平铺 -> 从屏幕左上角开始，逐行向右下均匀排列。	（若屏幕不足以平铺所有猫猫，将自动退回随机位置排序）
		 
		5.从右上角起，向左下均匀平铺 -> 从屏幕右上角开始，逐行向左下均匀排列。	（若屏幕不足以平铺所有猫猫，将自动退回随机位置排序）
	

🔄【补丁信息 & 已知问题】

	🔖 适配的游戏补丁：Community Voting, Language Filter & Fixes
	📅 主补丁发布日期：2026年04月20日 14:31（北京时间）
	📅 热更新发布日期：2026年04月20日 14:31（北京时间）

	🛠 Mod 发布日期：2026年04月21日 10:06（北京时间）
	🏷 Mod 发布版本：V2.7.1-win+b4
	
	⚠️ 已知问题：
		🔔 异常归属：【Steam 交互限制】
		📌 异常功能：【Mod - 开箱时间】
		❌ 异常现象：设置【开箱时间为 30 秒】时，极大概率导致【物品合成异常】、【宝箱数量更新延迟】等问题
		✅ 解决方案：设置开箱时间 1 分钟或以上，避免频繁操作
		
		🔔 异常归属：【游戏本体】
		📌 异常功能：【玩家猫猫显示】
		❌ 异常现象：房间列表可见玩家名字，但猫猫不显示
		✅ 解决方案：尝试重新进出房间、尝试让对方重新进出房间（已向游戏开发者反馈）
		
		🔔 异常归属：【游戏本体】
		📌 异常功能：【宝箱开启】
		❌ 异常现象：连续点击宝箱图标会连续开启多个宝箱
		✅ 解决方案：避免快速点击（已向游戏开发者反馈）
		
		
🔧【Mod 更新日志】

	📁 V2.7.1-win+b4：
		📌 适配：适配游戏主补丁更新 -> 2026年04月20日 14:31（北京时间）

	📁 V2.7.1-win+b3：
		📌 适配：适配游戏热补丁更新 -> 2026年04月18日 04:46（北京时间）

	📁 V2.7.1-win+b2：
		📌 适配：适配游戏热补丁更新 -> 2026年04月16日 01:14（北京时间）

	📁 V2.7.1-win+b1：
		📌 适配：适配游戏主补丁更新 -> 2026年04月13日 20:59（北京时间）
		📌 适配：适配游戏热补丁更新 -> 2026年04月13日 22:20（北京时间）
		📌 新增：弹幕文本持久化，发送弹幕文本后仍保留上次输入的文本

	📁 V2.7.0-win+b1：
		📌 正式支持 Windows + macOS 平台！
		📌 Mod 版本构建号统一化

	📁 V2.7.0：
		📌 适配：适配游戏热补丁更新 -> 2026年04月10日 22:12（北京时间）

	📁 V2.6.9：
		📌 移除：1 分钟后自动获取 “2026 愚人节大逃杀战斗胜利皮肤 - Blood Splatter Cat”
		📌 适配：适配游戏热补丁更新 -> 2026年04月04日 16:09（北京时间）

	📁 V2.6.8：
		📌 新增：1 分钟后自动获取 “2026 愚人节大逃杀战斗胜利皮肤 - Blood Splatter Cat”
		📌 适配：适配游戏主补丁更新 -> 2026年04月01日 20:37（北京时间）
		📌 适配：适配游戏热补丁更新 -> 2026年04月01日 21:25（北京时间）

	📁 V2.6.7：
		📌 适配：适配游戏热补丁更新 -> 2026年03月26日 18:48（北京时间）

	📁 V2.6.6：
		📌 适配：适配游戏热补丁更新 -> 2026年03月26日 03:21（北京时间）
		📌 优化：【立即解锁除点数外的全部成就！！】功能

	📁 V2.6.5：
		📌 适配：适配游戏热补丁更新 -> 2026年03月25日 19:57（北京时间）

	📁 V2.6.4：
		📌 修复：V2.6.3【Mod - 猫猫位置排序】失效问题
		
	📁 V2.6.3：
		📌 适配：适配游戏主补丁更新 -> 2026年03月23日 23:09（北京时间）
		
	📁 V2.6.2：
		📌 优化：游戏彩蛋领取信息
		📌 优化：设置项名称通俗化

	📁 V2.6.1：
		📌 新增：【立即解锁除点数外的全部成就！！】功能：字面意思啦 ~
		📌 适配：适配游戏主补丁更新 -> 2026年03月05日 23:26（北京时间）

	📁 V2.6.0：
		📌 新增：【隐藏全部猫猫时排除好友】功能
		📌 新增：【使用时不消耗 “烟花” 物品】功能（无限放烟花，不消耗库存数量）

	📁 V2.5.7：
		📌 适配：适配游戏主补丁更新 -> 2026年02月17日 03:13（北京时间）

	📁 V2.5.5：
		📌 适配：适配游戏热补丁更新 -> 2026年01月21日 22:06（北京时间）
		📌 优化：【隐藏全部猫猫】按钮增加交互延迟

	📁 V2.5.4：
		📌 修复：【隐藏全部猫猫】后，新进房间玩家显示默认皮肤的问题
		📌 修复：【点击计数栏隐藏宝箱】与【自动隐藏计数器】冲突问题

	📁 V2.5.3：
		📌 适配：适配游戏主补丁更新 -> 2026年01月17日 22:49（北京时间）

	📁 V2.5.2：
		📌 修复：【隐藏全部猫猫】无法对后续进入的猫猫生效

	📁 V2.5.1：
		📌 适配：适配游戏热补丁更新 -> 2026年01月06日 20:05（北京时间）

	📁 V2.5.0：
		📌 新增：【刷新猫猫位置排序】功能
		📌 新增：【隐藏全部猫猫】功能
		📌 优化：Mod 功能设置项分类排序

	📁 V2.4.1：
		📌 新增：【立即获得 1,000,000 点数】功能
		📌 移除：【敲击 + 1000 点数】功能
		
	📁 V2.4.0：
		📌 新增：【点击计数栏隐藏宝箱】开关
		📌 优化：设置项名称通俗化
		📌 优化：开箱失败时仍采用 Mod 设定时间（而非强制60秒）

	📁 V2.3.6：
		📌 新增：物品栏鼠标悬浮显示物品名称
		
	📁 V2.3.5：
		📌 其他：更新文档描述及常见问题

	📁 V2.3.4：
		📌 修复：V2.3.3【Mod - 自动开箱】失效问题

	📁 V2.3.3：
		📌 新增：多人大厅输入 XV40 并点击 Join 领取全部彩蛋
		📌 新增：大厅 ID 输入框显示彩蛋总数
		📌 修复：自动开箱状态在重启游戏后立即执行的问题

	📁 V2.3.2：
		📌 新增：开箱时间 30 秒选项（谨慎使用）
		📌 调整：物品箱与表情箱开启间隔 0.5 秒

	📁 V2.3.1：
		📌 适配：适配游戏主补丁更新 -> 2025年12月01日 16:06（北京时间）
		📌 移除：启动游戏时，若存在宝箱，则临时调整缺货时间为 5 秒

	📁 V2.3.0：
		📌 解锁：解除游戏宝箱囤积上限（原最多10个）
		📌 适配：适配游戏热补丁更新 -> 2025年11月26日 00:37（北京时间）

	📁 V2.2.2：
		📌 适配：适配游戏热补丁更新 -> 2025年11月25日 19:28（北京时间）

	📁 V2.2.1：
		📌 优化：【自动隐藏计数器】机制
		
	📁 V2.2.0：
		📌 新增：猫猫位置排序功能（5种模式）	
		📌 适配：适配游戏热补丁更新 -> 2025年11月25日 06:31（北京时间）
	
	📁 V2.1.1：
		📌 适配：适配游戏热补丁更新 -> 2025年11月23日 19:26（北京时间）
	
	📁 V2.1.0：
		📌 优化：开箱提示图标可通过点击点数栏切换显示
	
	📁 V2.0.0：
		📌 新增：全新 V2.0 版本！支持实时生效的个性化配置！